home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 013 / cweep214.arc / CWEEP.DOC < prev   
Encoding:
Text File  |  1985-07-27  |  16.3 KB  |  381 lines
  1. .OP
  2. .PO0
  3.                     CWEEP - A SWEEP-like program for MS-DOS
  4.  
  5.  
  6.                                 By Gary M. Berg
  7.                               5850 Duncraig Drive
  8.                                  Apartment 806
  9.                               Dayton, Ohio   45426
  10.      
  11.                               C.I.S. # 70106,1624
  12.      
  13.             Copyright (C) 1984, 1985 by Gary M. Berg/Chemineer Inc.
  14.      
  15.      
  16.                                    Disclaimer
  17.      
  18.         This software has been released to the public domain by the author.
  19.      All commercial rights are retained by the author.  It may be freely
  20.      passed on to others as long as no charge is made except for possibly a
  21.      small copying charge.  Although this software is thought to work as
  22.      described, no warranty of fitness is made for this software.
  23.      
  24.      
  25.      
  26.         CWEEP is a program to provide the same capabilities for the MS-DOS
  27.      user as the program SWEEP does for the CP/M user.  It provides the
  28.      ability to take a sorted list of the files on a disk and move forward
  29.      and backward in the list.  Files can be viewed, copied, deleted
  30.      individually and in groups.
  31.      
  32.         CWEEP is invoked at the MS-DOS command line by:
  33.      
  34.                     CWEEP {d:}{path}{afn} {-sw} {-sw}
  35.      
  36.           {d:}      an optional drive letter, the default being the
  37.                     currently logged drive
  38.      
  39.           {path}    an optional path.  Valid only for the 2.x version.
  40.      
  41.           {afn}     an optional ambiguous filename of what files to look
  42.                     at, the default begin "*.*" (in the currently logged
  43.                     directory under DOS 2.x).
  44.      
  45.           {-sw}     an optional switch or switches.  Switches begin with a
  46.                     '-' character.
  47.      
  48.         CWEEP will then look up all files matching the specified files, and
  49.      prompt with the first file name.  At this point, commands can be
  50.      entered to move around in the list, tag files, copy files, etc.  The
  51.      display on the next page was generated by starting CWEEP with no
  52.      filename specified:
  53.  
  54.  
  55.  
  56.                                      Page 1
  57. .PA
  58. è                    CWEEP - A SWEEP-like program for MS-DOS
  59.  
  60.  
  61.           CWEEP                    (Display for version 1.x)
  62.      
  63.                                  CWEEP version 1.37
  64.                  Copyright (C) 1985 by: Gary M. Berg/Chemineer Inc.
  65.      
  66.               sp/cr Advance to next file      [M]  Mass copy tagged files
  67.                [A]  Re-tag '#' marked files   [N]  Calculate CRC
  68.                [B]  Back up one file          [P]  Protected mass copy
  69.                [C]  Copy file to drive        [R]  Rename a file
  70.                [D]  Delete a file             [S]  Sort directory
  71.                [E]  Erase (un)tagged files    [T]  Tag a file
  72.                [F]  Free space on a drive     [U]  Untag a file
  73.                [H]  Hexidecimal display       [V]  View file
  74.                [I]  Print size/time for file  [W]  Wildcard file tag
  75.                [J]  Jump to a named entry     [X]  Exit program
  76.                [L]  Log new drive/filename    [Z]  Change subdirectory
  77.              [?],[/]Print this message        [=]  Goto settings menu
  78.      
  79.              [-?], [+?] List other help messages, [@] for printer
  80.      
  81.              47 files, using 226089 bytes (245K)  -- 19968 bytes free (20K)
  82.      
  83.        1. I:CW-COPY .C   08-Feb-1985     7K :[X] eXit
  84.      
  85.      
  86.      or
  87.      
  88.           CWEEP                    (Display for 2.x version)
  89.      
  90.                                  CWEEP version 2.14
  91.                  Copyright (C) 1985 by: Gary M. Berg/Chemineer Inc.
  92.      
  93.               sp/cr Advance to next file      [M]  Mass copy tagged files
  94.                [A]  Re-tag '#' marked files   [N]  Calculate CRC
  95.                [B]  Back up one file          [P]  Protected mass copy
  96.                [C]  Copy file to drive        [R]  Rename a file
  97.                [D]  Delete a file             [S]  Sort directory
  98.                [E]  Erase (un)tagged files    [T]  Tag a file
  99.                [F]  Free space on a drive     [U]  Untag a file
  100.                [H]  Hexidecimal display       [V]  View file
  101.                [I]  Print size/time for file  [W]  Wildcard file tag
  102.                [J]  Jump to a named entry     [X]  Exit program
  103.                [L]  Log new drive/filename    [Z]  Change subdirectory
  104.              [?],[/]Print this message        [=]  Goto settings menu
  105.      
  106.              [-?], [+?] List other help messages, [@] for printer
  107.      
  108.              48 files, using 227027 bytes (246K)  -- 18944 bytes free (19K)
  109.      
  110.        1. I:CW-COPY .C   08-Feb-1985     7K :[X] eXit
  111.                                      Page 2
  112. .PA
  113. è                    CWEEP - A SWEEP-like program for MS-DOS
  114.  
  115.  
  116.         The files matching what was specified (in this case *.*) are sorted
  117.      in alphabetic order, and the first file in the list is listed on the
  118.      screen with the date and the size rounded up to the nearest 1K.  In
  119.      addition, the amount of space free and the amount of space used in the
  120.      selected files is displayed.
  121.      
  122.         The following is a list of commands with a short explanation:
  123.      
  124.           [@]       This character may be prefixed to a command to cause
  125.                     the output of the command to also go to the printer.
  126.                     This works with the [?] help, [H]ex, [N] CRC, [Q]uery,
  127.                     and [V]iew commands.  If the command is a "paged"
  128.                     display, form-feeds will automatically be added to the
  129.                     printer output every 60 lines.
  130.      
  131.           <sp>
  132.           <cr>      Advance to the next file on the list.  Go to the first
  133.                     file on the list if you are at the last file on the
  134.                     list.
  135.      
  136.           [A]       Re-tag all files which are marked with a "#" in the
  137.                     list.
  138.      
  139.           <bs>
  140.           [B]       Back up to the previous file in the list.  Go to the
  141.                     last file in the list if B is entered when you are
  142.                     waiting at the first file on the list.
  143.      
  144.           [C]       Copy this file to another drive.  Prompt for the drive
  145.                     to copy to.  Destination drive can be entered in the
  146.                     form "d[:[v]]".  The if the "v" is specified, then the
  147.                     copy will be verified.  If the file already exists, the
  148.                     user will be queried about whether to delete it or not.
  149.                     In version 2.x, the destination may be given as a
  150.                     subdirectory.  The default drive will be the current
  151.                     one.
  152.      
  153.                     "A"               - Copy to drive A
  154.                     "A:"              - Copy to drive A
  155.                     "B:V"             - Copy to drive B, and verify copy
  156.                     "B:\GARY:V"       - Copy to subdirectory "\GARY" on
  157.                                         drive B.  Verify the copy.
  158.                     "OTHER\SOME:V"    - Copy to subdirectory "OTHER\SOME"
  159.                                         on the logged drive.  Note that
  160.                                         this is a relative subdirectory,
  161.                                         relative to the current sub-
  162.                                         directory on the logged drive.
  163.  
  164.  
  165.  
  166.                                      Page 3
  167. .PA
  168. è                    CWEEP - A SWEEP-like program for MS-DOS
  169.  
  170.           [-C]      Copy file to another file name.  Need to specify what
  171.                     the new drive and file name are.  Append a ":V" to the
  172.                     end of the new name if you want the copy verified.
  173.                     Specify the destination subdirectory if required with
  174.                     version 2.x.
  175.      
  176.           [D]       Delete file.  You are asked to verify deletion.
  177.      
  178.           [E]       Erase all tagged or untagged files.  User is prompted
  179.                     for which type of files to erase, and whether the user
  180.                     should be prompted about each file or not.  At most
  181.                     options an "A" will abort the operation.
  182.      
  183.           [F]       Check free space on any drive.
  184.      
  185.           [H]       Dump the file in hex format.  The escape and return
  186.                     keys abort the dump, any other key pauses it.
  187.      
  188.           [-H]      Dump the file in hex one 'page' at a time.
  189.      
  190.           [I]       Display the file size in bytes and the creation time.
  191.      
  192.           [J]       Jump to the file in the list.  Specify name and
  193.                     extension, it will jump to the closest point in the
  194.                     list.
  195.      
  196.           [L]       Log in a new drive (directory on V2.x) and ambiguous
  197.                     filename.  Will replace the list currently being used
  198.                     by one matching what was entered.  If no period (".")
  199.                     is in the string, a "*.*" will be appended to the
  200.                     string for the ambiguous filename.
  201.      
  202.           [M]       Copy all files which have been tagged to a specified
  203.                     drive.  The syntax is the same as for the Copy option.
  204.                     This option WILL delete (without warning) any files
  205.                     existing on the destination if they match a file which
  206.                     is being copied.
  207.      
  208.           [N]       Calculate a CRC for this file.  This is the same CRC as
  209.                     the CP/M program CRCK returns.
  210.      
  211.           [-N]      Calculate CRC's for all tagged files.
  212.      
  213.           [+N]      Calculate CRC's for all untagged files.
  214.      
  215.           [-O]      Output a list of all tagged files to a disk file.
  216.           [+O]      Output a list of all untagged files to a disk file.
  217.      
  218.           [P]       Protected mass copy option.  Same as "M" option except
  219.                     that the user will be queried before existing files are
  220.                     deleted.
  221.                                      Page 4
  222. .PA
  223. è                    CWEEP - A SWEEP-like program for MS-DOS
  224.  
  225.  
  226.           [-Q]      Display a list of tagged files.
  227.      
  228.           [+Q]      Display a list of untagged files.
  229.      
  230.           [R]       Rename the file to something else.  A wildcard new name
  231.                     is allowed.  If just "*" is entered, a wild card may be
  232.                     entered for the old and new names.
  233.      
  234.           [S]       Sort the directory in order by name, extension, date,
  235.                     or size.  Preceed the sort field by "-" to invert the
  236.                     normal order.
  237.      
  238.           [T]       Tag a file.  It will appear in the listing marked with
  239.                     a "*", and will be used in any operations which work on
  240.                     tagged files.
  241.      
  242.           [U]       Untag a file.  Clears the "*" marker.
  243.      
  244.           [V]       Display the file.  It ignores line feeds, and converts
  245.                     returns and vertical tabs to return/linefeed.  This
  246.                     allows listing files created by programs which only put
  247.                     returns in the file, such as Spellbinder.  The listing
  248.                     can be controlled by using return or escape to
  249.                     terminate, and any other key to pause.
  250.      
  251.           [-V]      Display file one 'page' at a time.
  252.      
  253.           [W]       Tag all files matching a wildcard.
  254.      
  255.           [-W]      Tag all files not matching a wildcard.
  256.      
  257.           [Z]       Enter a CHDIR command.  Only valid for MS-DOS versions
  258.                     2.0 and higher.
  259.      
  260.           [?]
  261.           [/]       Print help text for all commands with no "+" or "-"
  262.                     prefix.
  263.      
  264.           [-?]
  265.           [-/]      Print help text for all commands with a "-" prefix.
  266.      
  267.           [+?]
  268.           [+/]      Print help text for all commands with a "+" prefix.
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.                                      Page 5
  277. .PA
  278. è                    CWEEP - A SWEEP-like program for MS-DOS
  279.  
  280.  
  281.           [=]       This will take you to a settings menu controlling
  282.                     several program flags.  These are:
  283.      
  284.                     [M]  Turn the menu printing on/off.  Turning it off
  285.                          will suppress printing the menu when logging a new
  286.                          file specification.  Same as the command line
  287.                          option "-?" or "-/".
  288.      
  289.                     [P]  Turn the path display on/off (V2.x only).
  290.      
  291.                     [Z]  Turn ctrl/Z processing on/off.  When on, viewing a
  292.                          file will stop on ctrl/Z.  When off, ctrl/Z is not
  293.                          considered an end of file.
  294.      
  295.                     [=]
  296.                     [Q]
  297.                     [X]  Exit the settings menu and return to normal
  298.                          operations.
  299.      
  300.                     [?]
  301.                     [/]  Print a help message.
  302.      
  303.      
  304.      
  305.                              COMMAND LINE SWITCHES
  306.      
  307.      The following is a list of valid command line switches for CWEEP.
  308.      They may follow or preceed the file specification to be logged in.
  309.      
  310.           [-?]
  311.           [-/]      Toggle the main help menus off.  If present, the main
  312.                     help menus will only be displayed when requested.  This
  313.                     setting may be altered from the mini-menu.
  314.      
  315.           [-p]      Toggle the display of the logged path off.
  316.      
  317.           [-z]      Toggle control/Z processing.  If present on the command
  318.                     line, control/Z will be ignored when encountered in a
  319.                     file being viewed.  This setting may be altered from
  320.                     the mini-menu.
  321.      
  322.           [-d]
  323.           [-e]
  324.           [-n]
  325.           [-s]      Set the initial sort order to ascending whatever.  The
  326.                     options are the same as in the [S] command.  If the
  327.                     switch is entered as [--x] then the order will be
  328.                     descending (i.e., [--d] will sort by descending date,
  329.                     or most recent first).
  330.  
  331.                                      Page 6
  332. .PA
  333. è                    CWEEP - A SWEEP-like program for MS-DOS
  334.  
  335.  
  336.         For the user who does not like the default settings of some of the
  337.      command-line switches in CWEEP (not for the faint of heart), it is
  338.      possible to patch the values with DEBUG.  If you unassemble the
  339.      beginning of the code, you will find several move word and move byte
  340.      instructions.  By changing the value moved to 1 (true) or 0 (false)
  341.      the default may be changed (note that sort-order is an ascii
  342.      character).  The move commands are (in order):
  343.      
  344.           1)
  345.                Console on          (Please don't change this!!)
  346.           2)
  347.                Printer off         (Please don't change this!!)
  348.           3)
  349.                Menu on             (The "M" in the settings menu)
  350.           4)
  351.                Initial sort order  (Lower case is ascending)
  352.                                    (Upper case is descending)
  353.           5)
  354.                Ctrl/Z on           (The "Z" in the settings menu)
  355.           6)
  356.                Path display on     (The "P" in the settings menu)
  357.      
  358.      
  359.         CWEEP is written in the C language, and compiled with the C-ware
  360.      DeSmet C compiler.  A Zenith Z-100 was used to develop it.  It has
  361.      been tested by myself or others on a Z-150, IBM PC, and a Wang PC.  It
  362.      uses some custom routines for reading and writing files and handling
  363.      all I/O to the keyboard and printer.
  364.      
  365.         Since CWEEP uses the MS-DOS bdos calls to read/write the keyboard,
  366.      commands such as Ctrl/P and Ctrl/N work for directing output to the
  367.      printer.  This allows the user to obtain a hardcopy listing of a
  368.      session with CWEEP.  I/O redirection in MS-DOS version 2.0 and higher
  369.      allows putting a copy of a session in a file.  However, the output
  370.      would not be displayed on the screen, making it difficult to use.  In
  371.      addition, input redirection may be used if you can figure out exactly
  372.      what the input should be.
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.                                      Page 7
  387.